home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 123 / stcitdoc.arc / STADEL.TUT < prev    next >
Encoding:
Text File  |  1987-09-10  |  15.6 KB  |  420 lines

  1. CITADEL TUTORIAL
  2. by Marlene Abriel
  3. 1987
  4.  
  5.  
  6.     This tutorial is intended to make all of you users *expert*
  7. citadel users. Download it, read it, study it, commit it to memory
  8. and keep it at your fingertips.....just in case.  I will attempt to
  9. take you through every step of a Citadel BBS, from a first time
  10. logon to a logoff.
  11.  
  12.     Now for a bit of background.  The Citadel system is a public
  13. domain BBS program, but don't let that scare you.  It is one of the
  14. best that I have seen, not that I'm a well travelled modemer. 
  15. Citadel is made up of rooms, like SIGS.  These rooms have names and
  16. you can travel from room to room quite easily.  Some rooms are for
  17. messages only, while others are for messages plus uploading and
  18. downloading.  Rooms can be Open to all users, Hidden to some and
  19. also have access by Invitation-Only.  You can tell what type of room
  20. it is, but more on that later.  You may leave messages in any room
  21. that you have access.
  22.  
  23.     Well, let's get started.  You call up a BBS and.....Oh no!  It's
  24. a Citadel! Fasten your seatbelt, take a firm grip of your keyboard
  25. and let's plow straight on in.  After the banner scrolls by, if
  26. there is one, you will see something like this:
  27.  
  28.    [L]ogin  read [E]nter etc.
  29.  
  30. (for the sake of simplicity, anything you have to type will be
  31. contained in a set of brackets, like this < > and a carriage return
  32. is <CR>)
  33.  
  34.     Now type <L>ogin.  You will be asked for a password or a <CR> if
  35. you  are a new user.  Type a <CR> and answer all the prompts.  Easy
  36. so far, eh? Now you're logged on and your password has been saved
  37. for future use.  On the  screen you should now see:
  38.  
  39.    [G]oto  read  [N]ew  [E]nter  [H]elp and probably some room names
  40.                     (I'll refer to these as Rn)
  41.  
  42.     The [G]oto will take you from room to room to read/enter messages
  43. and u/l and d/l  in directory rooms.  Let's take a look at the rooms
  44. and learn how to tell what type of rooms they are.  To call up a
  45. list of all Known rooms for your access, type a <K>nown.  It might
  46. look something like this:
  47.  
  48.    
  49.    Mail>  Story>*  Music]*  Poetry]
  50.  
  51.     Notice the different brackets and the *.  They all have meaning. 
  52. The > means that it is an ordinary room with just the basic message
  53. options.  The * tells us that the room is an Invitation-Only room. 
  54. The only way to get access to  these rooms is if a user with access
  55. to that room invites you and that user must be an AIDE (like a sysop).
  56. Usually these rooms are Hidden and you won't even see them on your
  57. Known Room list.  These rooms are used for private  conversations
  58. and/or games....the sysop can even be evicted and he/she won't have
  59. access to it!  More about Hidden rooms....if a room is hidden and is
  60. not an Invitation-Only room and you know the Rn, you can go to it by
  61. typing <.><G>oto<Rn><CR>and it will appear in your Known Room list
  62. from then on.  The ] means that the room is a directory room. 
  63. Besides the usual messages, these rooms will allow u/l and d/l or
  64. just u/l or just d/l.  The ]* means that the room is an Individual-Only
  65. directory room.  You may at some point in time see others like a :
  66. after the Rn.  This designates the room as a  Shared room.  Shared
  67. rooms network with other Citadel BBS's and you must have Net
  68. Privileges in order to leave a message that will Net.  Don't worry
  69. about this for now.
  70.  
  71.     The Mail room is an Email room.  It is *very* private.  The mail
  72. can only be read by the sender and the receiver.  The sysop can't
  73. even read it!  
  74.  
  75.     A <?> will get you a menu from just about anywhere on a Citadel
  76. BBS.  Use it often if need be.  There are two ways to enter your
  77. commands:
  78.  
  79.        1) single 1-key functions
  80.        2) commands preceded by a `.'
  81.  
  82. I prefer to type <.> as the prefix because it gives you more control
  83. of where you're going and when reading messages you get a prompt for
  84. [N]ext or [R]eply. The <.> also allows more commands.  Following is
  85. a list of the 1-key commands, for interest sake.
  86.                     
  87.                 STadel 1-KEY Functions 
  88.             ________/Reading rooms\________ 
  89.             [N]ew messages   [O]ld messages 
  90.             [F]orward read   [R]everse read 
  91.             _______/Getting  around\_______ 
  92.             [G]oto a room with NEW messages 
  93.             [S]kip room      [U]ngoto room  
  94.             [K]nown rooms    [Z]forget room 
  95.             ______/Telecommunicating\______ 
  96.             [E]nter message  [C]hat w/Sysop 
  97.             ________/Getting  help\________ 
  98.             [H]elp        [?]list options 
  99.             __________/In & Out\___________ 
  100.             [L]ogin       [T]erminate (off) 
  101.             ------------------------------- 
  102.             [.] is a prefix for extended cmds 
  103.                   (try .H EXTENDED) 
  104.                For more help, type .H? 
  105.  
  106.     Let's move around Citadel with the <.> prefix.  
  107.  
  108.  
  109.    TO GOTO A ROOM
  110.    --------------
  111.   
  112.                        Type <.><G>oto<Rn><CR>  
  113.  
  114.     The Rn is the roomname and must be at least the 3 unique letters
  115. of the name  of the room which you wish to visit.  For example:
  116. there are two rooms named NSACUG General and NSACUG Sigs.  If you
  117. picked 3 letters out of the NSACUG, which is common to the two
  118. roomnames, Citadel will go to the first one and you would probably
  119. not get to the other room at all.  By choosing 3 unique, consecutive
  120. letters from General or Sigs, you will go to that room.  The Rn
  121. prompt will change to the name of the new room.
  122.  
  123.     <.><G>oto<Gen><CR>  -  goto to NSACUG General
  124.     <.><G>oto<igs><CR>  -  goto to NSACUG Sigs
  125.  
  126.     Just remeber that if you don't get where you intended, that the 3
  127. letters you have choosen might be found in another roomname.
  128.  
  129.  
  130.    TO READ MESSAGES
  131.    ----------------
  132.  
  133.    Type <.><R>ead<A>ll<CR>     - read all messages in the room
  134.         <.><R>ead<N>ew<CR>     - read only new messages in the room
  135.         <.><R>ead<O>ld<CR>     - read old messages in the room
  136.         <.><R>ead<R>everse<CR> - read all messages in reverse order
  137.         <.><R>ead<F>orward<CR> - read all messages in forward order
  138.    
  139.     The last two are useful if you're searching for a particular
  140. message. While you're reading messages there are 4 commands that are
  141. available to you.
  142.  
  143.     <J>ump   <N>ext   <P>ause   <S>top
  144.  
  145.    <J>ump will skip to the next paragraph of the current message.
  146.    <N>ext will stop the current message and skip to the next message.
  147.    <P>ause will pause the printing of the current message until
  148.     another key is pressed.
  149.    <S>top will return you immediately to the room prompt.
  150.  
  151.     These 4 commands will work anytime the system is printing
  152. messages or you are reading a text file online.
  153.  
  154.     There may be time that you just want to log on and read the
  155. messages in a certain room.  With Citadel it is possible to read
  156. only one room and retain the messages in other rooms as "new" for
  157. the next time you call.  All you have to do is log on, type
  158. <.><G>oto<Rn><CR> and read the room and then log off.  If you're
  159. online and decide that you don't want to read a room, do the same
  160. thing, or if you are already in the room, type <S>kip.  This will
  161. cause you to skip the room and the contents will be "new" the next
  162. time you log on.  If  you have skipped a room and before you log off
  163. you want to read the messages, just type <.><G>oto<Rn><CR> and voila,
  164. you're there.
  165.  
  166.  
  167.    TO ENTER MESSAGES
  168.    -----------------
  169.  
  170.          Type <.><E>nter<?><CR>       - will give you a menu
  171.               <.><E>nter<M>essage<CR> - enter the message
  172.   
  173.     Typing a <?> will give a menu of all the available message entry
  174. and saving commands:
  175.              <A>bort entry
  176.              <C>ontinue
  177.              <H>old Message for later
  178.              <N>et Save         (must have net privileges - explained later)
  179.              <P>rint formatted  (view message)
  180.              <R>eplace string   (edit)
  181.              <S>ave message
  182.  
  183.     After typing in the message a blank line and <CR> will get you
  184. the "Enter cmd:" prompt.  Select one of the above.  Citadel formats
  185. all messages to the screen width of the caller.  Carriage returns
  186. are treated as blanks unless preceeded by a space, so if you want
  187. paragraphs (and not a mess) indent a  couple of spaces.
  188.  
  189.     The <H>old Message for later, is a unique feature of the Citadel
  190. systems. This option allows you to put the message you are entering
  191. into a temporary buffer and returns you to the Rn prompt.  You may
  192. continue to use the BBS normally, reading/entering more messages. 
  193. Usual use of this is to read more message and update the message you
  194. re leaving or to move into another room because you think that the
  195. text of the message is more appropriate there.  
  196.     Only *one* message can be held at a time.  To continue a message
  197. in the Hold buffer type:
  198.  
  199.           <.><E>nter<H>eld  message<CR>
  200.  
  201.     The message wil print across the screen and then you can
  202. continue with it,  hold it again, save it or abort.  Whatever your
  203. little heart desires.  Well, that about covers it for messages.
  204.  
  205.  
  206.    DIRECTORY ROOMS:  Rn] 
  207.    ---------------
  208.  
  209.     Remember the ] bracket?  To read the directory of files in a
  210. directory room type:
  211.  
  212.            <.><R>ead<D>irectory<CR>
  213.  
  214.     This will list the files names and sizes.  The sysop, if he's a
  215. good one, will have prepared a brief description of the files for you.
  216. To read them and the filenames type:
  217.  
  218.            <.><R>ead<E>xtended<D>irectory<CR>
  219.  
  220.     You may specify certain file types.  For example, if you want to
  221. view all the available .DOC files in this room, type:
  222.  
  223.            <.><R>ead<D>irectory<*.DOC><CR>
  224.   
  225.     You can read files while online one of 3 commands:
  226.  
  227.            <.><R>ead<T>extfile<CR>    - this formats to screen width
  228.           *<.><R>ead<F>ile<CR>        - just reads
  229.           *<.><R>ead<F>ile<fn><CR>    - this reads a specific file
  230.  
  231.     The last two are unique to the ST version of Citadel and will
  232. not work on other versions. 
  233.  
  234.     How are you making out so far?  Now that you've got the message
  235. system figured out and can move around the BBS, let's go for a file
  236. transfer.
  237.  
  238.  
  239.    
  240.    FILE TRANSFERS
  241.    --------------
  242.  
  243.     File transfer a very easy on a Citadel BBS.  You must be in a
  244. directory room.  There is a WC protocol (Ward Christensen protocol),
  245. which I don't know anything about.  I don't use it......maybe
  246. someone can fill us in this.  The other protocol which is used is
  247. the standard Xmodem protocol.
  248.  
  249.    Downloads
  250.    ---------
  251.  
  252.     There are two commands which are self explanatory:
  253.  
  254.    <.><R>ead<X>modem<B>inary<CR>
  255.    <.><R>ead<X>modem<T>extfile<CR>
  256.  
  257.     CRC is supported in both cases.
  258.  
  259.    Uploads
  260.    -------
  261.  
  262.     These are self explanatory as well:
  263.  
  264.    <.><E>nter<X>modem<B>inary<CR>
  265.    <.><E>nter<X>modem<F>ile<CR>
  266.    <.><E>nter<X>modem<M>essage<CR>
  267.    
  268.     The last one is used to u/l a message that you have prepared
  269. before you called the BBS; ideal if you have a review or short
  270. article.  I'm not sure, but when you initiate a
  271. <.><E>nter<X>modem<M>essage, I think the prompt you get is:  "Ready
  272. for WC transfer? (Y/N)"......answer <Y> and don't worry about the WC
  273. part (only if you're ready, of course).   
  274.  
  275.     I think just about covers the basics.  Following is a little
  276. more detail.
  277.  
  278.  
  279.  
  280.    FORGET ROOMS
  281.    ------------
  282.  
  283.     <Z> when in a room will cause you to forget the room.  It
  284. removes the name from your list and you will not go be able to go
  285. there unless you Unforget the room.  Why would you want to forget a
  286. room?  Well, there might a room created for the discussion of
  287. Chippendale men.......now, if you're a *man* you wouldn't want to be
  288. bothered...I hope!......so type <.><G>oto<C>hippendale and type <Z>.
  289. Zap! it's gone.  To get a list of all the rooms that you have
  290. forgotten just type <.><Z> and there they are.  If you want to
  291. Unforget a room and get it back on your list, type <.><G>oto<the
  292. ENTIRE Rn>.  A partial name will not work. Now for a couple of rules.
  293. You can forget any room, except the Mail and what is called the Lobby.
  294. The lobby is the first room that you are in when you log on. The
  295. <.><Z> will only list the public rooms that you have forgotten.  If
  296. you have forgotten a private room, better jot the Rn down.  You can
  297. return to a forgotten private room with the Unforget command.
  298.  
  299.    NETWORKING
  300.    ----------
  301.  
  302.     All of you have probably heard that a Citadel BBS can network
  303. with others. This feature is only made possible if the sysops of two
  304. or more boards have made previous arrangements.  Let's pretend that,
  305. that has been done.  A room which has networking capabilities will
  306. have a : after the Rn to designate that its is a Shared room (one
  307. with net cap.).  What will happen if you enter a net message with
  308. the following command?
  309.  
  310.    <.><E>nter<N>et-message 
  311.  
  312.     This message will be sent to the other nodes (BBS's which share
  313. this room).   The sysops sent up certain times to do this and
  314. Citadel takes over and will do the networking automatically.  This
  315. feature is handy, especially if you want to leave a message on a BBS
  316. and it's busy (and it networks with another BBS). 
  317.  
  318.     If you have already typed the message using the <.><E>nter<M>essage
  319. and  before you save it, you decide that you would like it to net
  320. with another node, you can do a Netsave by typing:
  321.  
  322.    <.><S>ave<N>et-message
  323.  
  324.  
  325.    LOGGING OFF THE SYSTEM
  326.    ----------------------
  327.  
  328.     You're all done and now you want to go home, right?  It's simple.
  329. Type:
  330.  
  331.    <.><T>erminate<Q>uit-also
  332.  
  333.     Bye, bye!  You're gone.
  334.  
  335.  
  336.    FINALE
  337.    ------
  338.  
  339.     There are usually help files available to be read online if you
  340. need them.
  341.     Type: <.><H>elp<help> will get you a list of them.  To read the
  342. help files
  343.     type: <.><H>elp<name of the help file>.
  344.  
  345.  
  346.    A LIST OF ALL THE AVAILABLE EXTENDED COMMANDS
  347.    ---------------------------------------------
  348.  
  349.   (note periods: "." and the letters to type in caps.)
  350.  
  351.   **** These commands are for AIDES only
  352.    .Aide ?
  353.    .Aide Delete-empty-rooms
  354.    .Aide Edit-room
  355.    .Aide Insert-pulled-message
  356.    .Aide Kill-room
  357.    .Aide Settime
  358.  
  359.   **** These commands are for everyone else
  360.    .Enter ?
  361.    .Enter Configuration (change your config setup)
  362.    .Enter File
  363.    .Enter Message
  364.    .Enter WC-protocol Message
  365.    .Enter Xmodem-protocol Message  (Synonym for .EWM)
  366.    .Enter Xmodem-protocol BinaryFile FILENAME.EXT
  367.    .Enter Xmodem-protocol File FILENAME.EXT
  368.    .Enter Password (change password)
  369.    .Enter Room (users can create a room for specific topic discussions)
  370.    .Enter Held-Message
  371.  
  372.    .Goto ?
  373.    .Goto ANYROOM (type in the Rn)
  374.    .Goto PARTIALROOMNAME (a unique 3 letter combo)
  375.  
  376.    .Help ?
  377.    .Help ANYFILE (name of the help file you want to read)
  378.  
  379.    .Known MATCH STRING     <search room list for matching room name>
  380.  
  381.    .Login PASSWORD
  382.  
  383.    .Read All (messages)
  384.    .Read Forward (messages)
  385.    .Read Global (messages)
  386.    .Read New (messages)
  387.    .Read Old (messages)
  388.    .Read Reverse (messages)
  389.  
  390.         (NORA == New, All, Reverse, or Old)
  391.    .Read WC-Protocol [NORA]    <Network format>   <CRC supported>
  392.    .Read Xmodem Protocol[NORA] <Normal format>    <CRC supported>
  393.  
  394.    .Read Status (status of the BBS)
  395.    .Read Directory
  396.    .Read Directory *.DOC
  397.    .Read Extended Directory
  398.    .Read Binaryfile PROGRAM.COM
  399.    .Read File ANYFILE.EXT
  400.    .Read Text File ANYFILE.EXT
  401.    .Read Text File *.DOC
  402.    .Read WC-Protocol BatchFile *.*           <CRC supported>
  403.    .Read WC-Protocol Textfile ANYFILE.EXT    <CRC supported>
  404.    .Read Xmodem BatchFile *.*                <CRC supported>
  405.    .Read Xmodem Textfile ANYFILE.EXT         <CRC supported>
  406.  
  407.    .Skip ?
  408.    .Skip ANYROOM
  409.    .Skip PARTIALROOMNAME
  410.  
  411.    .Terminate Stay
  412.    .Terminate Quit-also
  413.  
  414.    .Ungoto ANYROOM
  415.    .Ungoto PARTIALROOMNAME
  416.  
  417.    .Z     <Lists public forgotten rooms>
  418.  
  419.    See Also Help Files
  420.